home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / batchut / vc10.zip / VC10.DOC < prev    next >
Text File  |  1991-05-20  |  6KB  |  202 lines
  1.  
  2. VOLUME CHECKER 1.0
  3.  
  4. BY USING THIS PROGRAM YOU AGREE TO HOLD THE AUTHOR FREE OF ALL
  5. LIABILITY OF ANY KIND TO THE EXTENT PERMITTED BY LAW.  YOU
  6. ASSUME THE RISK OF ANYTHING THAT HAPPENS.  VOLUME CHECKER IS
  7. SOLD WITHOUT WARRENTY OF ANY KIND, INCLUDING FITNESS FOR A
  8. PARTICULAR PURPOSE OR MERCHANTABILITY.  REMEDIES ARE LIMITED TO
  9. THE REFUND OF THE REGISTRATION FEE.
  10.  
  11.  
  12. Volume checker does NOT run under DOS version 2.x
  13.  
  14.               -----------------------------
  15.  
  16.                       Super quick lesson:
  17.  
  18.         VC thisdisc a
  19.         VC Label Drive
  20.  
  21.                      Returns errorlevel 0 if 'thisdisc' is in A:
  22.  
  23.               -----------------------------
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36. ------------------------
  37. CONTENTS
  38.  
  39. What is it?
  40. How do I use it?
  41. Single floppy systems
  42. Return codes
  43. Suppress output
  44. Redirection
  45. Registration
  46. Other programs
  47.  
  48. ------------------------
  49. WHAT IS IT?
  50.  
  51. Volume checker is a batch utility that looks at the volume
  52. label of any drive and compares it to the one entered on the
  53. command line.  It returns errorlevel based on what it finds.
  54. This allows you to do backups with a batch file that copy the
  55. contents of particular directories to particular floppies, etc.
  56.  
  57. I have a lot of batch files to port from my bbs machine to my
  58. work machine.  By using VC I can make sure that the files go on
  59. the floppies they belong on.  Also, I can designate a
  60. particular floppy for a particular job, and make sure it is not
  61. inadvertently written to by a batch file.
  62.  
  63. ------------------------
  64. HOW DO I USE IT?
  65.  
  66. The command line for VC is:
  67.  
  68. VC NAME [drive letter]
  69.  
  70. The A drive is assumed if no letter is given on the command
  71. line.  The registered version has other options.
  72.  
  73. ------------------------
  74. SINGLE FLOPPY SYSTEMS
  75.  
  76. VC makes the assumption that if you have a single floppy
  77. system, and the floppy drive is aliased to B:, you just forgot
  78. it there. If you have one drive and last used it as B:, VC will
  79. do the assembly language equivolent of A: and press a key to
  80. make the floppy think of itself as the A drive.  This means if
  81. you call VC first, you will not get stuck at the prompt that
  82. says 'insert diskette for drive A: and strike any key when ready.'
  83.  
  84. However, if you _specify_ the B drive, VC will take you at your
  85. word. So if you have two drives, it will look at the B drive,
  86. if you have one, and it is aliased as B, it will access it, and
  87. if it is aliased as A, you will get the prompt.  Which won't
  88. make your day if you are a sysop using VC in your night
  89. maintenace batch file.  Therefore:
  90.  
  91. Unless you are doing something I never thought of, DO NOT
  92. specify drive B on a single floppy system.
  93.  
  94. ------------------------
  95. RETURN CODES
  96.  
  97. VC returns errorlevel:
  98.  
  99. 0 if it finds the right disc in the drive.
  100. 1 if the disc has no volume label.
  101. 2 if the volume label is not the one you looked for.
  102. 3 if the disc is not a dos formatted disc. *
  103. 4 if there is not even a disc in the drive.
  104. 5 if an invalid command line or other program error.
  105.  
  106. * I have not yet gotten around to coding this, so VC does not do this this
  107. errorlevel yet.
  108. ------------------------
  109. SUPPRESS OUTPUT
  110.  
  111. an & character on the command line after the volume label you
  112. are checking for will cause output to be suppressed by the registered
  113. version.
  114.  
  115. example:
  116.  
  117. VC BACKUP-016 B &
  118.  
  119. Will look for the volume backup-016 in the b: drive, and return the same
  120. error codes but will not display anything.
  121.  
  122. ------------------------
  123. REDIRECTION
  124.  
  125. The output of VC can be sent to nul to get rid of it with:
  126.  
  127.         VC Volumename [drive letter] > nul
  128.  
  129. or to a file with:
  130.  
  131.         VC Volumename [drive letter] > filename
  132.  
  133. You can create a log of what the program has done complete with
  134. dates and times by adding the following to your batch file:
  135.  
  136.  
  137.       type dots.dat >> vc.log
  138.       echo Y|more|date >> vc.log
  139.       echo Y|more|time >> vc.log
  140.       type cr.dat >> vc.log
  141.        vc label drive [options] >> vc.log
  142.  
  143. Where dots.dat is just a line of dots or something to separate entries,
  144. and cr.dat is a file that is just a couple of carriage returns.
  145.  
  146. The begging messages of the unregistered version cannot be
  147. redirected.
  148.  
  149. ------------------------
  150. REGISTRATION
  151.  
  152. Registered users will not get the 'begging' messages.  Yes, I
  153. realize they are annoying.  I started out thinking people would
  154. register if gently reminded, and found out it was not true.
  155. Registration of this program is only a buck.  If you're too
  156. cheap to pay that, then perhaps you deserve to be pestered.
  157.  
  158. To register, send one buck and a self addressed stamped
  159. envelope to:
  160.  
  161. Drake Koefoed  1409 Oak Patch Road # A9 Eugene, OR 97402
  162.  
  163. Or send two bucks, and I will provide the envelope and address
  164. it and stamp it for you.
  165.  
  166. Or send one buck and the name and password you will be using,
  167. and log onto my bbs to find out how to create the registered
  168. version.  The bbs is:
  169.  
  170. Assembler bbs (503) 343-6383
  171.  
  172. You can also leave messages on:
  173.  
  174. Out in the Styx bbs (503) 345 2582
  175.  
  176. If you write and do not send a self addressed envelope, I won't answer.
  177. If you send a buck and no self addressed stamped envelope, I
  178. will assume you intend to call the board for registration
  179. information.  I answer mail even without registrations, but not
  180. without the self addressed stamped envelope.
  181.  
  182. ------------------------
  183. OTHER PROGRAMS
  184.  
  185. VC is preceded by PRIN28, a printing program that prints out
  186. unformatted or misformatted files as if they had been done on a
  187. word processor.  Prin will put the filename and date and time
  188. created at the top of the printout, add a left margin, print to
  189. file, number the pages, print in doublespace, wrap excessively
  190. long lines, and control the number of lines per page as
  191. specified by the user.  Good for program source code, batch
  192. files, and text files formatted by people who don't know your
  193. printer can't do that many lines on a page.  Prin, like VC, is
  194. written in assembler for high speed.  Prin is multitasker
  195. aware, and will run in a 7k window.
  196.  
  197. I may do some more batch utilities, and if I do, I will
  198. probably use the same method to create the registered version.
  199. If you are a registered user of VC, and you find something else
  200. by me that is later, try it and see.  If it works, that will be
  201. my way of saying thanks for registering VC.
  202.